| guestfs-python(3) | Virtualization Support | guestfs-python(3) |
НАЗВА¶
guestfs-python — як використовувати libguestfs з Python
КОРОТКИЙ ОПИС¶
import guestfs
g = guestfs.GuestFS(python_return_dict=True)
g.add_drive_opts("disk.img", format="raw", readonly=1)
g.launch()
ОПИС¶
На цій сторінці підручника наведено документацію щодо викликів libguestfs з коду мовою програмування Python. На сторінці задокументовано відмінності від програмного інтерфейсу C та подано декілька прикладів. Якщо ви не дуже знайомі із користуванням libguestfs, вам також слід прочитати підручник з guestfs(3).
python_return_dict=True¶
Увесь новий код має будувати дескриптор за допомогою такого:
g = guestfs.GuestFS(python_return_dict=True)
Це вказує на те, що ваша програма потребує отримання словників Python для методів у програмному інтерфейсі, які повертають таблиці хешів.
У майбутніх версіях libguestfs цей спосіб має стати типовим.
ВИНЯТКИ¶
Помилки від функцій libguestfs пов'язуються із "RuntimeException" з єдиним рядковим аргументом, яким є текст повідомлення про помилку.
ДОДАТКОВА ДОКУМЕНТАЦІЯ¶
Тип:
$ python >>> import guestfs >>> help(guestfs)
КОРИСТУВАННЯ ПРИВ'ЯЗКАМИ ДО PYTHON У ВІРТУАЛЬНОМУ СЕРЕДОВИЩІ¶
Ці прив'язки недоступні у pypi через проблеми із ліцензуванням. За станом розв'язання проблем можна слідкувати тут: https://bugzilla.redhat.com/1075594.
Втім, ми оприлюднюємо дистрибутив Python для вибраних стабільних версій libguestfs на http://libguestfs.org/download/python. Ви можете скористатися ним за допомогою такої команди:
pip install http://libguestfs.org/download/python/guestfs-1.XX.YY.tar.gz
ПРИКЛАД 1. СТВОРЕННЯ ОБРАЗУ ДИСКА¶
@EXAMPLE1@
ПРИКЛАД 2. ПЕРЕВІРКА ОБРАЗУ ДИСКА ВІРТУАЛЬНОЇ МАШИНИ¶
@EXAMPLE2@
ТАКОЖ ПЕРЕГЛЯНЬТЕ¶
guestfs(3), guestfs-examples(3), guestfs-erlang(3), guestfs-gobject(3), guestfs-golang(3), guestfs-java(3), guestfs-lua(3), guestfs-ocaml(3), guestfs-perl(3), guestfs-recipes(1), guestfs-ruby(3), http://libguestfs.org/.
АВТОРИ¶
Richard W.M. Jones ("rjones at redhat dot com")
АВТОРСЬКІ ПРАВА¶
Copyright (C) 2010-2023 Red Hat Inc.
LICENSE¶
BUGS¶
To get a list of bugs against libguestfs, use this link: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
When reporting a bug, please supply:
- The version of libguestfs.
- Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
- Describe the bug accurately and give a way to reproduce it.
- Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report.
| 2023-02-21 | libguestfs-1.50.1 |